home *** CD-ROM | disk | FTP | other *** search
/ Floppyshop 2 / Floppyshop - 2.zip / Floppyshop - 2.iso / art&graf.ix / art-3485 / art-5110 / imcon.1_1 / imconeng.txt < prev    next >
Text File  |  1995-01-21  |  16KB  |  371 lines
  1.                                 ImCon v1.1
  2.                                ============
  3.  
  4. This is the English documentation of ImCon version 1.1. The German version of 
  5. this text is in the file "IMCONGER.TXT".
  6. Dies ist die englische Dokumentation von ImCon Version 1.1. Die deutsche 
  7. Ausgabe dieses Textes finden Sie in der Datei "IMCONGER.TXT".
  8.  
  9.  What is ImCon?
  10. ================
  11. ImCon is a program with which you can convert pictures between different file 
  12. formats. On the way, you can apply some changes to the picture, like zooming 
  13. or dithering. You may also view pictures. ImCon features a full GEM User 
  14. Interface.
  15.  
  16.  Legal Section
  17. ===============
  18. ImCon is Freeware, i.e. you may use and copy it freely as long as you copy all 
  19. the files listed in 'README.TXT' and don't change any of them. However, if you 
  20. use ImCon regularly, it would be nothing more than fair to send me a little 
  21. donation of about 30 DM / $20.
  22. ImCon is provided AS IS without any guarantees or warranty. The author is not 
  23. responsible for any damage or losses of any kind caused by the use or misuse 
  24. of the program.
  25.  
  26.  Hardware Requirements
  27. =======================
  28. ImCon should run on all ATARI ST style computers (includes Ste, TT, Falcon, 
  29. ...). Because I didn't have the possibility to test ImCon on a Falcon or under 
  30. MultiTOS, I can't say for sure whether it will work or not.
  31.  Memory:
  32. ImCon requires a lot of memory. You should disable the accessories and the 
  33. programs in the AUTO folder on a 512K machine.
  34.  Graphics:
  35. ImCon should work with most graphic cards, since it uses GEM to access the 
  36. screen. However, I don't know how HighColor and TrueColor hardware can by 
  37. accessed via GEM, and I expect ImCon will treat it like black and white 
  38. screens.
  39.  
  40.  Installation
  41. ==============
  42. Copy the files 'IMCON.PRG' and 'IMCON.DAT' together into a folder or onto a 
  43. disk and that's it. To start, double-click on 'IMCON.PRG'.
  44.  
  45.  The Menu Bar
  46. ==============
  47.  
  48.  Menu 'IMCON'
  49. Here you'll fin the usual info-dialog and the accessories.
  50.  
  51.  Menu 'File'
  52.  'Open...'
  53. This brings up a Fileselector to choose the file to load. ImCon tries to 
  54. recognize the format of the file, in some cases you'll have to tell it the 
  55. right format. After loading the file, ImCon creates a new window which 
  56. represents the image data just loaded.
  57.  
  58.  'Open As...'
  59. This brings up a Fileselector to choose the file to load. After that a dialog 
  60. will appear where you must enter the dimensions and the mode of the picture. 
  61. You can use this item to load certain uncompressed picture formats. If you 
  62. have no idea what I'm talking about, you'd better forget that this item is 
  63. there.
  64.  
  65.  'Close'
  66. This closes the frontmost window and frees the memory associated with it. 
  67. CAUTION! Don't forget to save the data BEFORE you close the window, because 
  68. there's no alert telling you the data hasn't been saved.
  69.  
  70.  'Save...'
  71. Use this to save the image from the frontmost window to a file. First pick the 
  72. format of your wish from the list, then enter path and name of the file to be 
  73. created in the Fileselector.
  74.  
  75.  'Cycle'
  76. Use this to cycle through the windows.
  77.  
  78.  'to Disk'
  79. Writes the image data of the frontmost window to disk and removes it from 
  80. memory. While the data is not in memory, you can't work with it.
  81.  
  82.  'to Memory'
  83. Reads the image data back into memory.
  84.  
  85.  'Quit'
  86. Quit ImCon. CAUTION! Don't forget to save the data BEFORE you quit ImCon, 
  87. because there's no alert telling you the data hasn't been saved.
  88.  
  89.  Menu 'Mode'
  90. The items in this menu allow you to convert an image between the different 
  91. modes. To convert a Paletted or TrueColor image to Bitmap, you have to convert 
  92. it to Grayscale first. For more details see 'Dithering'.
  93.  
  94.  Menu 'Zoom'
  95.  'Zoom 200%'
  96. Doubles both the width and the height of the picture.
  97.  
  98.  'Zoom X Factor...'
  99. Enlarges the width of the picture by a given factor.
  100.  
  101.  'Zoom Y Factor...'
  102. Enlarges the height of the picture by a given factor.
  103.  
  104.  'Zoom 50%'
  105.  'Zoom X 50%'
  106.  'Zoom Y 50%'
  107. These items can be used to shrink Grayscale and TrueColor images.
  108.  
  109.  'Scale...'
  110. Zooms the picture to a size you specify. With '< Calc' you can recalculate the 
  111. size so that the proportions of the image will remain the same.
  112.  
  113.  'Canvas...'
  114. This changes the size of an image without zooming it. If the new dimensions 
  115. are larger than the old ones, if will put a border around the image. If the 
  116. new dimensions are smaller, the image will be clipped. You have to tell ImCon 
  117. where to position the old picture within the new one.
  118.  
  119.  Menu 'Image'
  120.  'View'
  121. Shows the frontmost picture. More details given below.
  122.  
  123.  'Invert'
  124. Inverts the picture.
  125.  
  126.  'Histogram...'
  127. Shows a histogram of the picture (shows how frequent each color is in the 
  128. picture). Use the arrow in the top right corner to switch between the channels 
  129. (Black, Red, Green, Blue). 'Optimize' and 'Optimize All' can be used to 
  130. optimize one or all channels. You may also click on the histogram itself to 
  131. move the small marks at its bottom. The changes are only applied when you 
  132. leave the box by clicking 'OK' or hitting the Return/Enter key.
  133.  
  134.  'Blur'
  135. A filter which makes the picture softer. Only available for Grayscale and 
  136. TrueColor.
  137.  
  138.  'Edit Palette...'
  139. Use this to edit the palette of a Paletted-picture.
  140.  
  141.  'Remove Unused'
  142. This removes unused and duplicate colors from a palette.
  143.  
  144.  Menu 'Options'
  145.  'Options...'
  146. This brings up the Options Dialog. Here you can set some switches to make your 
  147. copy of ImCon fit to your needs. All changes you make only come into effect 
  148. when you leave the dialog with 'OK'. The switches are:
  149.  
  150.  [Use Dithering]
  151. Here you can switch dithering on and off. Dithering may be used when 
  152. converting pictures from Grayscale to Bitmap, from Grayscale to Paletted and 
  153. from TrueColor to Paletted.
  154.  [Real Gray Scaling]
  155. Enables a better but slower algorithm for scaling Grayscale and TrueColor 
  156. pictures.
  157.  [Hex Color Values]
  158. This switches between decimal and hexadecimal color values in 'Edit Palette'.
  159.  [Tiff Save]
  160. These two options control the format of pictures being saved in 'TIFF' format. 
  161. You can enable or disable Intel Byte Order and LZW Compression.
  162.  [View Background]
  163. Here you may select the background pattern to be used when viewing pictures.
  164.  [Canvas Background]
  165. Here you may select the background pattern to be used in 'Canvas'.
  166.  [View Mode]
  167. This switch contols how pictures are displayed.
  168.  [TrueColor Planes]
  169. Activate this switch if you want the three planes of TrueColor pictures to be 
  170. shown as seperate planes instead of a vertical arrangement.
  171.  
  172.  'Save Options'
  173. This will save the settings in the dialog described above in the file 
  174. 'IMCON.DAT'.
  175.  
  176.  Dithering
  177. ===========
  178. When you convert TrueColor and Grayscale pictures to Paletted or Bitmap, some 
  179. of the information in the picture is lost. To keep this loss of information 
  180. within acceptable borders, there are some special algorithms, called 
  181. dithering. They convert a certain color in the original picture to a mixture 
  182. of different colors in the dithered picture. The perception of this mixture is 
  183. much closer to the original color than it would be without dithering.
  184. The algorithm ImCon uses is called Error Diffusion Dithering. Its advantage is 
  185. that it creates almost no regular patterns. You may also switch dithering off 
  186. in the 'Options' Dialog.
  187. If you tell ImCon to convert from Grayscale to Paletted, it will ask you how 
  188. many colors (levels of gray in fact) the palette should have. Possible values 
  189. are 2 to 256. When converting from TrueColor to Paletted, things are a bit 
  190. more complicated. You have to choose from:
  191.  'Uniform'
  192. Creates a palette with colors that are uniformly distributed within the color 
  193. space. The number of colors must also be specified in the dialog box. Since 
  194. the number of colors has to be the product of three integer values, the actual 
  195. number of colors you get may be smaller than the number you specified.
  196.  'Exact'
  197. This will check whether the picture really uses more than 256 colors. If this 
  198. is not the case, the picture can be converted without any loss of information.
  199.  'Load'
  200. This allows you to load a palette you previously saved in the 'ImCon Palette' 
  201. format. You may also load one of the predefined palettes distributed together 
  202. with ImCon.
  203.  'Previous'
  204. This gives the picture the palette back it had the last time it was a Paletted 
  205. picture. An example: you want to use 'Blur' on a Paletted picture. To do this, 
  206. you have to convert it to TrueColor (using '-> TrueColor' in the menu 'Mode'). 
  207. After blurring, you use the 'Previous' option and the resulting picture will 
  208. have the very same palette it had before the operation.
  209.  
  210.  Viewing
  211. =========
  212. Viewing of pictures very much depends on the available hardware. ImCon doesn't 
  213. talk directly to the hardware, but uses GEM instead. The advantage of using 
  214. GEM is that ImCon will probably work wogether with new ATARI hardware and 
  215. graphic cards. However, I don't know HighColor and TrueColor modes can be 
  216. accessed through GEM. I expect ImCon will act like on black and white in this 
  217. modes.
  218. For Bitmap images, viewing is no problem. For all other modes there are three 
  219. possibilities between you can choose in the Options Dialog:
  220.  Memory
  221. The picture is shown like it is stored in memory. Every pixel of the picture 
  222. will appear as 8 black and white pixels on the screen.
  223.  Color
  224. The picture is transformed so it can be displayed with real color or 
  225. grayscales. Of course this will only work when you've got a color monitor. For 
  226. Paletted pictures your hardware must also support enough colors.
  227.  Planes
  228. The picture is devided into its bit planes, i.e. you get up to 8 black and 
  229. white pictures where each pixel in one plane represents a certain bit of the 
  230. respective pixel.
  231.  
  232.  Key Commands in Viewing Mode
  233. ==============================
  234. To scroll around, use the cursor keys or the keypad. Shift makes the movement 
  235. faster, Control makes it slower. To return, press 'Q', 'X', Escape, Return, 
  236. Enter, Undo, Delete or Backspace. With '+' and '-' you can switch between the 
  237. planes. 'I' inverts pictures that are being viewed in black and white (Memory 
  238. and Planes mode or Bitmap pictures). Unlike 'Invert' in the menu 'Image', this 
  239. doesn't change the picture permanently.
  240.  
  241.  Supported Formats
  242. ===================
  243.  Doodle (.PIC .DOO)
  244. Simple black and white Bitmap, always 640 by 400 pixels (ST high resolution).
  245.  
  246.  Degas (.PI1 - .PI3)
  247. Format created by ST paint program 'Degas', also supported by almost every 
  248. other paint program. This is an uncompressed format and limited to the 3 ST 
  249. resolutions.
  250.  
  251.  Degas Elite (.PC1 - .PC3)
  252. Format created by ST paint program 'Degas Elite', the successor of 'Degas'. 
  253. The format is compressed, but still limited to the 3 ST resolutions.
  254.  
  255.  NEOchrome (.NEO)
  256. Format created by ST paint program 'NEOchrome'. The format is uncompressed and 
  257. limited to the 3 ST resolutions. However, if have only encountered low 
  258. resolution files.
  259.  
  260.  STAD (.PAC)
  261. Format created by ST paint program 'STAD'. STAD pictures are always black and 
  262. white, 640 x 400 pixel pictures. The pictures are compressed. ImCon can't 
  263. write this format.
  264.  
  265.  Tiny (.TNY / .TN1 - .TN3)
  266. These files are created by the program 'TINYSTUF', which can be used to store 
  267. Degas and NEOchrome pictures with more efficient compression. ImCon can't 
  268. write this format.
  269.  
  270.  Art Director (.ART)
  271. Format created by ST paint program 'Art Director'. These files are 
  272. uncompressed, low ST resolution pictures. Only the first of the 16 palettes is 
  273. used. ImCon can't write this format.
  274.  
  275.  Spectrum 512 (.SPU / .SPC)
  276. Format created by ST paint program 'Spectrum 512'. This program uses some 
  277. tricks to display up to 512 colors simultaneously in ST low resolution. 
  278. However, most Spectrum pictures don't use more than 256 colors. ImCon will 
  279. scan the image during loading to see if it really uses more than 256 colors. 
  280. Only if this is the case, the picture will be loaded as TrueColor. Can't be 
  281. written.
  282.  
  283.  AIM Grayscale (.IM)
  284. Format of the 'ATARI Image Manager'. Only grayscale pictures with a size of 
  285. 256 x 256 or 128 x 128 pixels are supported directly. Pictures with other 
  286. dimensions can be loaded using 'Open As...'. Just select 'Grayscale' and enter 
  287. the correct width and height of the picture.
  288.  
  289.  GEM Image (.IMG)
  290. GEM's standard format for storing pictures. ImCon supports the XIMG extention 
  291. and TrueColor pictures.
  292.  
  293.  IFF Bitmap (.IFF)
  294. The standard picture format of the AMIGA. ImCon supports the HAM and HAM8 
  295. formats and loads them as TrueColor pictures. However, when you save TrueColor 
  296. pictures in IFF format, they will always be full 24 bit pictures.
  297.  
  298.  ZSoft PCX (.PCX)
  299. Format created by PC paint program 'Paintbrush'. Only version 3.0 pictures 
  300. with a VGA palette are supported. Can't be written.
  301.  
  302.  CompuServe GIF (.GIF)
  303. A hardware independent format defined by CompuServe. It offers up to 256 
  304. colors and very efficient compression (LZW).
  305.  
  306.  TIFF (.TIF)
  307. Another independent format defined by Aldus and Microsoft. This format is 
  308. widely used in the PC and Macintosh world. TIFF is a very liberal format, 
  309. allowing many different data arrangements and compression schemes. Here's a 
  310. list of what ImCon doesn't understand:
  311. - PackBits, CCITT 1D and Facsimile compression
  312. - rotated and flipped pictures (Orientation)
  313. - Grayscale and TrueColor pictures with not exactly 8 bits per pixel
  314. - Paletted pictures with more than 256 colors
  315. - Files with FillOrder 2
  316. ImCon ignores all information for exact color reproduction (ResponseCurves, 
  317. Gamma, WhitePoint). There are two options in the 'Options' Dialog which 
  318. control the format of picture files saved by ImCon in this format.
  319.  
  320.  ImCon Internal (.IMC)
  321. This format can be used to temporarily store images on disk. Since it is 
  322. identical with the internal format used in memory it is loaded and saved 
  323. without loosing time for some difficult conversion. However, the internal 
  324. format used by ImCon may change at any time without notice, and so will do 
  325. this file format, so don't use it for permanent storage of pictures.
  326.  
  327.  ImCon Palette (.IMP)
  328. This format is no real picture format. It only contains a palette. This format 
  329. can be used to save a palette and use it later when converting a TrueColor 
  330. picture to Paletted.
  331.  
  332.  Restrictions
  333. ==============
  334. ImCon doesn't allow pictures to be bigger than 4096 by 4096 pixels. Almost 
  335. everything else is only limited by available memory and the operating system.
  336.  
  337.  Changes from version 1.0
  338. ==========================
  339. - Fixed a fatal bug in viewing Grayscale pictures.
  340. - The commandline is now evaluated.
  341. - The XAcc-protocoll is now supported. However, you can't exchange pictures 
  342. with other applications in this version.
  343. - The AV-protocoll is supported, if ImCon is running in a multitasking 
  344. environment together with GEMINI.
  345. - ImCon will warn you if you're going to overwrite an existing file.
  346. - Dispersed Dot Ordered Dithering has been removed. Error Diffusion Dithering 
  347. gets you better results, so there's no need for it.
  348. - The Conversion TrueColor -> Paletted got it's own dialog.
  349. - ImCon now remembers the number of colors you entered for the TrueColor to 
  350. Paletted and Grayscale to Paletted conversions.
  351. - New menu item 'Open As...' to load dump files.
  352. - TIFF files may now be written uncompressed and with Intel byte order.
  353.  
  354.  Copyright Acknowledgements
  355. ============================
  356. The Graphics Interchange Format(c) is the Copyright property of CompuServe 
  357. Incorporated. GIF(sm) is a Service Mark property of CompuServe Incorporated.
  358.  
  359.  My Adress
  360. ===========
  361. If you found a bug, have an idea how ImCon could be improved or want ImCon to 
  362. read a new format, please write a letter to me. If my efforts to solve the 
  363. problem result in a new version of ImCon, I'll send you that new version. My 
  364. adress is:
  365.  
  366.   Christoph Pfisterer
  367.   Moritzburger Weg 38d
  368. D 01109 Dresden
  369.   Germany
  370.  
  371.